Configurar importação de e-mail
Pré-requisitos
- Tipo de workflow configurado.
- Acesso ao menu Configuração > Importação de e-mail (WF015).
Apresentação
A importação consiste na captura de todos os e-mails enviados para uma determinada conta.
Conforme o que for configurado na importação, é possível agendar a inicialização de workflows a partir dos e-mails.
No SoftExpert Workflow, a importação de e-mail é configurada no menu Configuração > Importação de e-mail (WF015).
Veja como realizar esta configuração:
Configurar importação de e-mail
1. Acesse o menu Configuração > Importação de e-mail (WF015) e clique no botão da barra de ferramentas.
2. Na tela de dados que será apresentada, informe um identificador e um nome para o agendamento.
3. Preencha os campos requeridos da aba Geral:
- Início: Informe a data e a hora de início da execução do agendamento.
4. Clique em . Neste momento, as demais abas serão habilitadas.
5. Preencha os campos na ordem das abas apresentadas na tela de agendamento:
Geral
Próxima execução
A data e a hora da próxima execução do agendamento são preenchidas conforme as informações de recorrência que serão preenchidas a seguir.
Recorrência
Configure a periodicidade da execução do agendamento:
Frequência: Selecione a frequência em que a execução do agendamento será realizada:
- Sem recorrência: A execução do agendamento será feita somente uma vez, ou seja, não terá repetição.
- Hora(s)/Minuto(s): A execução do agendamento será feita em intervalo de horas ou minutos. Informe, no campo "a cada __ hh:mm", o intervalo desejado. Por exemplo: a cada 01:15, a cada 00:30, a cada 03:00, etc. Obs.: Não será possível selecionar um tempo inferior a 15 minutos para o agendamento.
- Diário: A execução do agendamento será feita em intervalo de dias. Informe, no campo "a cada __ dia(s)", o intervalo desejado. Por exemplo: a cada 2 dias, a cada 5 dias, etc.
- Semanal: A execução do agendamento será feita em dias específicos da semana. No campo "Dias da semana", marque os dias nos quais a execução do agendamento deverá ser realizada. Por exemplo: toda segunda-feira, quarta-feira e sexta-feira.
- Mensal: A execução do agendamento será feita em determinados meses do ano. No campo "Meses", marque os meses em que a execução do agendamento deverá ser realizada.
Término da recorrência: Selecione neste campo como será o término da recorrência da execução do agendamento:
- Sem data de término: A recorrência da execução do agendamento não terá fim definido.
- Termina após: A execução do agendamento termina após determinado número de ocorrências. Informe, no campo "Ocorrências", a quantidade limite de ocorrências de execuções do agendamento.
- Termina em: A execução do agendamento termina em uma determinada data. Selecione, no campo "Data", o dia, mês e ano em que a execução do agendamento terminará.
Excluir ao finalizar agendamento
Marque esta opção para que o registro seja excluído após o término da execução do agendamento.
Configuração
Servidor de e-mail
- Protocolo: Selecione o protocolo a ser utilizado pelo servidor. O protocolo IMAP é o mais recomendado por permitir manter as mensagens no servidor apenas marcando-as como lidas. O protocolo POP3 é um protocolo antigo que, por padrão, exclui a mensagem após ela ter sido lida. O SE Suite não suporta a utilização da autenticação oAuth 2.0 (obrigatória para as contas de e-mail da Microsoft e do Google) com o protocolo POP3.
- Endereço do servidor: Informe o endereço do servidor.
- Porta: Informe a porta do servidor.
- Usuário/Senha (visível com a autenticação básica): Informe o usuário e a senha da conta que terá os e-mails capturados. Utilize o botão Testar para verificar a conexão com o servidor.
- Client ID: Código de identificação da aplicação no servidor de e-mail no qual está configurada a autenticação oAuth 2.0.
- Secret ID: Valor da credencial para acesso à caixa postal da conta de e-mail. Este valor pode ser visto no portal do servidor apenas no momento da criação da credencial.
- Usuário: Conta de e-mail que será monitorada (necessário incluir o domínio).
- Access Token: Código de autorização utilizado para realizar a autenticação da conta de e-mail. Para gerá-lo, é necessário clicar no botão Gerar novo token para ser aberta uma janela de login da própria Microsoft ou Google. Este token tem um tempo limite e pode ser utilizado uma única vez.
- Desativar busca parcial de conteúdo MIME: Marque esta opção para que não seja utilizado o recurso de recuperação parcial de um conteúdo de e-mail do tipo MIME.
Durante configuração do oAuth 2.0 no portal da Microsoft ou Google, será necessário informar a URL que receberá o valor do Access Token. Este endereço deverá ser: “https://{CONTEXTO_SUITE}/se/workflow/gn_scheduling/inbox_processor/oauth_token.php”
O “CONTEXTO_SUITE” precisa ser substituído pelo endereço do servidor onde está o SoftExpert Suite.
Por exemplo: "sesuite.softexpert.com"
Não será permitido o uso dos mesmos dados da configuração da caixa de entrada (Servidor e Usuário) em mais de um agendamento ativo. Somente será possível repetir os dados de um agendamento inativo.
Regras
Configure as operações que serão executadas pelo agendamento de importação de e-mail.
1. Para isso, clique no botão da barra de ferramentas lateral.
2. Na tela que será aberta, informe um nome para a regra.
O campo Sequência será automaticamente preenchido com a ordem de cadastro da regra, porém, quando houver outras regras já configuradas, esse sequencial poderá ser alterado.
A sequência define a ordem com que as regras serão processadas. Caso haja duas ou mais regras, a segunda regra somente será processada se a primeira regra falhar, a terceira regra somente será processada se a segunda regra falhar, e assim por diante. Ou seja, assim que for encontrada uma regra que possua as condições de aceitação do e-mail, o sistema irá executá-la e ignorar todas as demais regras seguintes.
O processamento das regras somente será finalizado assim que alguma regra não falhar (e ser executada), ou até que não haja mais regras para serem processadas.
Recomenda-se que regras mais complexas, como executar uma atividade, ou regras com condições muito específicas sejam as primeiras regras a serem processadas (valor sequencial mais baixo), enquanto regras mais fáceis de passar sejam as últimas da sequência.
3. Na aba Geral, preencha os seguintes campos:
Tipo de execução
Selecione a operação que será executada com a regra em questão:
- Instanciar processo: Selecione esta opção para que a regra execute a inicialização do objeto configurado neste agendamento.
- Incluir histórico: Selecione esta opção para que a regra inclua um registro no histórico do objeto configurado neste agendamento. Para aceitação das regras configuradas com esta ação, o assunto da mensagem de e-mail deve conter o identificador da instância entre os caracteres "<<" e ">>". Ex.: "Aprovação do chamado <<000011>> conforme combinado".
- Executar atividade: Selecione esta opção para que a regra execute uma ação de uma atividade do objeto configurado neste agendamento. Em seguida, selecione a atividade a ser executada no campo Atividade de execução e selecione, no campo Ação a ser executada, qual ação será executada na atividade. Para aceitação das regras configuradas com esta ação, o assunto da mensagem de e-mail deve conter o identificador da instância entre os caracteres "<<" e ">>". Ex.: "Aprovação do chamado <<000011>> conforme combinado".
Processo/Tipo de Workflow
Esta seção será habilitada se a opção "Instanciar processo" estiver selecionada no campo Tipo de execução:
- Processo: Selecione o processo que será inicializado pela regra.
- Tipo de Workflow: Selecione o tipo de workflow que será inicializado pela regra.
- Iniciador padrão: Selecione o usuário que será considerado o iniciador da instância.
- Definir o remetente como Iniciador caso ele seja um usuário cadastrado: Marque esta opção para que o remetente da mensagem importada seja o iniciador do processo, caso exista um usuário cadastrado com o mesmo endereço de e-mail do remetente. Caso não exista um usuário ou o remetente não possua permissão para instanciar o processo, o iniciador padrão será definido como iniciador do processo.
- Atributo para armazenar o remetente: Selecione o atributo do processo que irá armazenar o e-mail do remetente da mensagem.
Execução
Esta seção será habilitada se a opção "Executar atividade" estiver selecionada no campo Tipo de execução:
- Atividade de execução: Este campo somente ficará habilitado se a opção "Executar atividade" estiver selecionada no campo Tipo de execução. Sendo assim, selecione a atividade do objeto que será executada.
- Ação a ser executada: Este campo somente ficará habilitado se a opção "Executar atividade" estiver selecionada no campo Tipo de execução. Sendo assim, selecione a ação para a execução da atividade do objeto.
Validar se o remetente é um usuário com permissão de execução
Esta opção somente ficará habilitada se a opção "Executar atividade" estiver selecionada no campo Tipo de execução. Marque esta opção para que a atividade somente seja executada caso o remetente do e-mail seja responsável pela execução da atividade, ou seja, para que o sistema verifique, através do endereço do e-mail do remetente, se ele é o executor da atividade.
Utilizar condições para a execução da regra
Marque esta opção para que esta regra somente seja executada quando uma das seguintes situações forem válidas:
- Executar regra somente se todas as condições forem válidas: Marque esta opção para que a regra em questão seja executada somente se todas as demais regras forem válidas.
-
Executar regra quando qualquer condição for válida: Marque esta opção para que a regra em questão seja executada quando ao menos uma das demais regras for válida.
4. Se a opção Utilizar condições para execução da regra tiver sido selecionada, a aba Condições ficará habilitada.
Clique no botão para adicionar uma condição. Na tela que será aberta, preencha os seguintes campos:
- Sequência: Este campo será preenchido automaticamente pelo sistema com a ordem da condição que está sendo cadastrada, porém, se houver outros registros de condições, esse valor poderá ser alterado.
- Origem: Defina a origem da condição que será testada: Remetente, Destinatários, Assunto, Conteúdo da mensagem, Data de envio, Prioridade ou Contém anexo.
- Operador: Selecione o operador a ser utilizado para testar a condição: Igual a, Diferente de, Contém, Não contém, Está contido em, Não está contido em, Está vazio ou Não está vazio. Este campo ficará desabilitado se for selecionada a opção "Contém anexo" para a origem.
- Valor fixo: Informe o valor que será utilizado pelo operador na origem. Este campo ficará desabilitado se for selecionada a opção "Contém anexo" para a origem ou se for selecionada a opção "Está vazio" ou "Não está vazio" para o operador.
Salve os dados da condição para que ela seja incluída na regra.
5. Salve os dados da regra.
Notificado
Nesta aba, defina os usuários que serão notificados por e-mail quando ocorrer algum erro na conexão com o servidor de e-mail durante a importação.
1. Para isso, clique no botão .
2. Na tela que será apresentada, no campo Notificar, selecione o tipo de grupo que classifica o destinatário do e-mail:
- Área: Os usuários de determinada área da organização serão os destinatários.
- Função: Os usuários que exercem determinada função na organização serão os destinatários.
- Área/Função: Os usuários de uma determinada área da organização e que exercem uma função específica serão os destinatários.
- Usuário: Um usuário específico será o destinatário.
- Equipe: Os membros de uma equipe cadastrada no sistema serão os destinatários do e-mail.
3. Os Filtros ficarão habilitados para que os usuários sejam preenchidos de acordo com o grupo selecionado.
4. Clique no botão da parte superior da tela para realizar a busca pelos usuários. O resultado da busca será apresentado de acordo com a opção selecionada no campo Notificar e os valores informados nos filtros.
5. Selecione aqueles que serão destinatários do e-mail. Utilize as teclas SHIFT ou CTRL do teclado ou o check ao lado de cada item para selecionar mais de um registro por vez.
6. No campo Permissão, selecione a opção Permitir para que os usuários selecionados recebam as notificações por e-mail ou selecione a opção Negar para que eles não recebam.
7. Clique .
Caixa de entrada
Nesta aba, serão apresentados os e-mails que foram capturados pelo agendamento.
Os e-mails serão copiados para o sistema com o objetivo de se obter uma melhor performance e dar maior cobertura no monitoramento da importação de e-mails.
Essa aba também apresenta o status da captura dos e-mails e outras informações, abordadas a seguir, facilitando, assim, a leitura e monitoramento da importação:
- Será possível visualizar as validações das regras aplicadas individualmente em cada mensagem dentro da caixa de entrada do agendamento.
- Serão exibidas as condições validadas contendo os parâmetros configurados na regra e o valor correspondente verificado na mensagem.
- As regras de execução de atividade e inclusão no histórico mostrarão uma mensagem de erro quando não for encontrado o identificador da instância no assunto.
- Processos configurados incorretamente deverão mostrar, de forma intuitiva, o aviso no histórico de agendamento e na validação da mensagem de e-mail.
- Permite o reprocessamento manual de mensagens rejeitadas ou que tiveram erro na importação.
6. Salve a seleção dos campos para que o registro seja incluído no agendamento.
Posteriormente, a aba Histórico apresentará os logs das execuções realizadas. Utilize os campos Situação, Data início e Data fim para filtrar os registros de log. Utilize o botão para visualizar os detalhes do registro de log.
Conclusão
A execução é realizada conforme a frequência de recorrência configurada na aba Geral.
Ao salvar o registro pela primeira vez, o sistema realizará a verificação da conta e captura dos e-mails de acordo com as configurações realizadas anteriormente.